home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / program / inter54e.zip / INTSUM16.ZIP / INTSUM.TXT < prev    next >
Text File  |  1996-10-13  |  5KB  |  93 lines
  1.  
  2.                   INTSUM.EXE - Interrupt Summary and Viewer
  3.                        For Ralf Brown's Interrupt List
  4.                      Copyright (c) 1995 Daniel D. Miller
  5.  
  6.               Written by Daniel D. Miller (derelict@netcom.com)
  7.  
  8.                        Version 1.6, released 09-18-95
  9.  
  10. ===============================================================================
  11.  
  12. This program, IntSum.EXE, and its associated source-code files, are hereby
  13. released to the public domain, although I retain the copyright on the
  14. existing source code.  You may modify and redistribute the source and
  15. executables in any form that you wish, anywhere you wish, for any purpose.
  16. I would be grateful if my name was retained in this document and in the
  17. source-code files as the original author.
  18.  
  19. Note that effective this date, 10-13-96, I am no longer supporting or
  20. maintaining this program.  I've switched to Windows 95 now, and the
  21. Windows Help version of the Interrupt List is vastly more powerful than
  22. anything I could ever get motivated to do with this.
  23.  
  24. ===============================================================================
  25.  
  26. IntSum is a character-mode MSDOS program for viewing the Interrupt List.
  27. It supports Release 45 and later, and will also work with earlier releases
  28. which follow the same file format.  It has the following features:
  29.  
  30.     -> Automatically supports current screen size in rows (it will work
  31.        properly with screens wider than 80 columns, but doesn't use the
  32.        extra width for anything).
  33.     -> IntSum automatically generates its own indexed reference file,
  34.        the first time that it is run.  The INTPRINT summary is not used.
  35.     -> There are NO size limits on reference or listing files.
  36.     -> Display colors may be set via entries in INTSUM.INI.
  37.        This file will automatically be created in the same directory
  38.        as INTSUM.EXE, the first time INTSUM is run.
  39.     -> Save Current Topic to File (from reference list only).
  40.     -> Combined-file support is now working!!
  41.     -> Added LIST_DIR item to the INI file, which permits user to
  42.        specify a separate directory for the Interrupt List files.
  43.        Thus, INTSUM.* may be kept anywhere in your path; it no longer
  44.        needs to be in the same directory as the Interrupt List files.
  45.  
  46. ===============================================================================
  47.  
  48. INTSUM.EXE is hereby released as freeware, though I retain the copyright on 
  49. it.  This means you may distribute it anywhere you wish, to anyone you wish,
  50. and use it for any private or commercial purpose, but you may not charge
  51. money for it (except for reasonable media distribution fees), nor may you 
  52. modify the program in any way.
  53.  
  54. ===============================================================================
  55.                             Combined-file support
  56.  
  57. When IntSum prepares to create a new index file (because INTERRUP.IDX is
  58. missing), it first searches for INTERRUP.LST in the directory where
  59. IntSum was found.  If such file is located, the index is built from that;
  60. otherwise, the index is built from INTERRUP.A and its brethren.
  61.  
  62. ===============================================================================
  63.                             DOS PATH utilization
  64.  
  65. IntSum now searches for the interrupt_list files, index, INI file, and any 
  66. other files in the directory where INTSUM.EXE was executed.  This means you
  67. can now path to IntSum and execute it without having to actually change
  68. to that directory.  For this to work, of course, IntSum must be in the
  69. same directory as the interrupt-list files.
  70.  
  71. Note: effective with version 1.3, the INTSUM.INI file allows the user to
  72. specify the path to the interrupt-list files.  IntSum does not have to be
  73. in the same directory with them; it can be somewhere convenient in your
  74. path.
  75.  
  76. ===============================================================================
  77.                              Configuration file
  78.  
  79. The first time that IntSum is executed, it will create a configuration file 
  80. called INTSUM.INI in the directory where INTSUM.EXE is located.  This file
  81. contains all the colors used by the program.  Once the file is created, you
  82. can edit it with any text editor, and set them to whatever colors you like.
  83. The file uses standard 8-bit DOS color scheme, where bit 7 is BLINK,
  84. bits 6-4 are background and bits 3-0 are foreground.  Values can be entered
  85. in hex as 0xHH, octal as 0DDD, or decimal as DDD.  If still confused, look
  86. up strtol() in a C-library reference manual.  I presume that anyone who
  87. is looking at an interrupt list is familiar with the DOS text color scheme.
  88.  
  89. The INI file also contains a line LIST_DIR, which allows the user to
  90. specify a separate path for the Interrupt List files, so INTSUM does not
  91. need to be in the same directory as Interrupt List distribution.
  92.  
  93.